Définition des flux

Comment effectuer le mapping des messages ?

Mapping de messages (EDIMSG)

Le mapping de messages permet d’associer les informations d’un message lié à une catégorie, à celles d’une représentation de Sage X3.

Plusieurs mappings de messages sont prédéfinis.

Vous pouvez définir d’autres mapping de messages par duplication. Cliquez sur Dupliquer, puis saisissez les nouvelles clés.

Pour créer un mapping, renseignez :

  • le code et la version de mapping de message,
  • le code catégorie,
  • la représentation de Sage X3. La table de la classe à laquelle la représentation est associée doit correspondre à la table déclenchante de la catégorie.

Le sens est défini automatiquement en fonction de la catégorie sélectionnée.

Pour les messages réceptionnés :

  • Vous devez indiquer les alias des champs utilisés comme référence pour effectuer les contrôles liés aux autorisations en réception (par exemple, pour le contrôle effectué sur le site, vous devez indiquer s’il s’agit du site de vente, du site de livraison, du site financier…).
    Trois alias doivent ainsi être renseignés : il s’agit du tiers, de l’adresse du tiers et du site.
Pour les messages émis, ces champs sont définis au niveau de la catégorie.

  • Vous devez également indiquer, dans la section Import, le modèle d’import utilisé.

    Les champs du modèle sont automatiquement affichés et chacun doit être mis en correspondance avec un alias de la représentation.

Pour les mappings portant sur les notifications de livraisons, aucun modèle d’import n’est à renseigner, la création et la suppression des notifications étant basée sur la méthode CRUD et non sur l’import de documents.

Une fois le mapping des messages défini, il sera ensuite utilisé :

  • Dans des flux.

    Vous pouvez consulter la liste des flux utilisant ce mapping, dans la section Flux.

  • Dans des fichiers séquentiels.

    Vous pouvez consulter la liste des fichiers séquentiels utilisant ce mapping, dans la section Fichiers séquentiels.

  • Dans des fichiers XML.

    Vous pouvez consulter la liste des fichiers XML utilisant ce mapping, dans la section Fichiers XML.

Comment définir le format EDI des fichiers séquentiels échangés ?

Fichier séquentiel EDI (EDISEQFIL)

Utilisez cet écran pour prédéfinir le format EDI des fichiers séquentiels à envoyer et à recevoir.

Un certain nombre de format EDI de fichiers séquentiels est prédéfini.

Sur la facette Query, tous les formats de fichiers définis sont affichés.
Vous pouvez afficher soit les formats de fichiers en émission, soit les formats de fichiers en réception en utilisant les filtres prédéfinis : Emission et Réception.

Définition du format

La définition d’un format consiste à indiquer :

  • Le mapping de message utilisé.

    La représentation, le nom de l’instance et le sens issus du mapping sont automatiquement affichés.

  • La norme du fichier.

  • Le fichier ou l’ensemble des fichiers physiques correspondant aux informations d’un document à envoyer ou recevoir. Pour une facture de vente, il peut s’agir par exemple du fichier d’en-tête, du fichier détail et du fichier contenant le pied de facture.

    Pour chacun d’eux, indiquez :

    • Son caractère obligatoire ou non.
    • Le code du fichier. Celui-ci est utilisé pour indiquer le lien de parenté entre fichiers physiques, lorsque plusieurs fichiers sont listés. Il est également utilisé au niveau de la liste des champs des fichiers pour indiquer, au niveau de chacun des champs, son fichier d’appartenance.

    • La racine de son nom. En réception, le nom du fichier doit également comporter obligatoirement l’extension du fichier. 

    • En émission, le nom du fichier peut également comporter d’autres composants tels que la date, l’heure, une constante, l’extension du fichier, etc. à préciser dans le bloc Définition du nom du fichier.
  • La structure utilisée pour gérer les données dans le fichier : type de fichier, séparateur décimal, séparateur d’enregistrement, format des dates, etc.

  • En réception, vous devez également renseigner une clé pour indiquer la propriété qui va être utilisée comme référence unique destinée à différencier un document d’un autre. Il s’agit, par exemple du numéro de commande client pour un document de commande de ventes.

  • La liste des champs ou propriétés, composant les fichiers séquentiels à envoyer ou recevoir est affichée. Il s’agit soit des propriétés issues de la classe associée à la représentation, soit de propriétés créées directement dans la représentation, à des fins de transcodification. La méthode Transcode fournie dans la représentation, permet d’indiquer pour chaque propriété utilisant cette méthode, le numéro de la table de transcodage à utiliser : les différentes valeurs à transcoder doivent être définies dans des tables de transcodage au niveau la fonction Transcodage Import/Export (GESAOR).

    Ces champs sont classés par :

    • code fichier physique,

    • niveau hiérarchique des types d’enregistrement à l’intérieur des fichiers physiques (par exemple : l’entête, les lignes, etc.),
    • position du champ dans l’enregistrement (utilisée principalement pour les types de fichier de format fixe).

Le caractère Obligatoire ou non de chacun des champs est également précisé.

En fonction du type de catégorie EDI, il peut s’avérer qu’un champ défini comme non obligatoire dans l’utilisation standard de Sage X3 soit ici défini comme étant Obligatoire.
Il s’agit par exemple du Code EAN de l’article pour les documents faisant référence à l’article, ou de la référence de la commande client pour les commandes de vente.


Vous pouvez également paramétrer d’autres fichiers séquentiels par duplication, en saisissant un code de Mapping de message et une version existante avec une nouvelle norme de fichier, préalablement définie dans la table diverse 2002.

Une fois le format du fichier défini, il sera utilisé dans des flux.

Vous pouvez consulter la liste des flux utilisant ce fichier séquentiel, dans la section Flux.

Télécharger un fichier XSD

Téléchargement fichier XSD (EDIXSDUPL)

Utilisez cet écran pour télécharger les fichiers des schémas XSD utilisés pour définir et valider les formats des fichiers XML échangés.

Le contenu des schémas est accessible auprès du tiers concerné :

  • FACTURAE pour les échanges avec l’administration publique espagnole.
  • CHORUS pour l’envoi de facture à l’administration publique française.
  • XRECHNUNG pour l’envoi de facture à l’administration fédérale allemande.
  • EDISOHXML pour la réception des commandes de vente. Ce schéma est fourni dans l’application.
  • DEB pour la génération des fichiers destinés à la génération de la déclaration Intrastat.

En création, le téléchargement s’effectue par simple copie dans la section Fichier, du schéma récupéré auprès du tiers.

Les schémas CHORUS et XRECHNUNG contiennent 13 fichiers XSD à télécharger dont le composant UBL CommonAggregateComponents-2.0 livré avec une taille réduite afin d’améliorer les performances.

Après téléchargement, le numéro d’identifiant unique (UUID) dans MongoDB de chacun de ces fichiers est affiché.

  • Dans la section Fichiers XML, vous pouvez consulter les mappings de messages qui utilisent ce schéma.

  • Dans la section Flux, vous pouvez consulter la liste des flux utilisant cette catégorie.

Comment définir le format EDI des fichiers XML échangés ?

Fichier XML EDI (EDIXMLFIL)

Utilisez cet écran afin de prédéfinir, à partir de la structure XSD, le format EDI des fichiers XML à envoyer et à recevoir.

Un certain nombre de formats EDI de fichiers XML est prédéfini.

Ils concernent :

  • la réception des factures d’achat,
  • la réception des commandes de vente,
  • la génération des factures de vente,

  • la génération des fichiers nécessaires à la déclaration DEB / Intrastat.

Sur la facette Query, tous les formats de fichiers définis sont affichés.
Vous pouvez afficher soit les formats de fichiers en émission, soit les formats de fichiers en réception en utilisant les filtres prédéfinis : Emission et Réception.

Pour définir un format XML, indiquez :

  • Le mapping de message utilisé.

    La représentation, le nom de l’instance et le sens issus du mapping sont automatiquement affichés au niveau de la section Paramètres.

  • La norme du fichier.
  • Le ou les schémas XSD à utiliser.

Cliquez sur Générer pour générer la liste des identifiants des chemins du fichier XML.

Cette liste est affichée dans le tableau Champs au niveau de la section Paramètres.

Définissez ensuite la concordance de chacun des identifiants avec chacune des propriétés issues de la classe associée à la représentation.

Une fois le paramétrage du fichier défini, il sera utilisé dans des flux.

Vous pouvez consulter la liste des flux utilisant ce fichier XML, dans la section Flux.

Qu’est-ce qu’un flux ?

Flux EDI (EDIFLO)

Un flux peut être schématisé de la façon suivante :


Définir un flux revient à packager ou envelopper des messages EDI. Cette démarche correspond à réunir les différents paramètres nécessaires à la mise en œuvre d’un échange, en indiquant :

  • Le partenaire.

    Celui-ci va déterminer le protocole utilisé.

    Le protocole n’est pas saisissable. Il s’agit du protocole associé au partenaire EDI, par catégorie.

  • La catégorie.

    Dans un flux, les messages appartiennent obligatoirement à la même catégorie. Cette catégorie doit être associée au partenaire renseigné.

    Les informations suivantes sont issues de la catégorie et ne sont pas modifiables :

    • Le sens : envoi / réception.
    • Le type d’opération : création / suppression.

  • Un mapping de messages associé à cette catégorie, avec les différents messages qui lui sont associés.

    Indiquez si le mapping utilise des fichiers au format séquentiel ou XML. Dans ce dernier cas, précisez si les fichiers XML générés doivent être signés au format XAdES ou ne font l’objet d’aucune signature.

  • Le ou les fichiers joints : vous pouvez renseigner au maximum cinq lignes :
    • Une ligne pour le fichier généré. Il s’agit du fichier joint généré à partir du code de l’état Crystal Reports renseigné. Vous pouvez toutefois choisir d’exclure le fichier principal (XML ou séquentiel) de l’envoi. Vous pouvez aussi choisir de signer le fichier joint généré. Dans le tableau valeurs paramètres, définissez pour chacun des paramètres de Crystal Reports, soit une valeur constante, soit une propriété.
      • Le champ destination permet de définir le type de fichier généré (PDF, WORD, etc.) selon le code destination (cette définition s’effectue dans la fonction de paramétrage des Destinations (GESAIM).
      • Le nom est fixe : vous générez un fichier joint avec un nom fixe dans le volume que vous indiquez.
      • Le nom n’est pas fixe. Il prend alors le nom du fichier principal. Son extension correspond à celle définie par le code destination (cette définition s’effectue dans la fonction de paramétrage des Destinations (GESAIM).
    • Quatre lignes pour des fichiers joints. Il s’agit de fichiers dont le nom est fixe : vous sélectionnez ces fichiers à partir du volume que vous indiquez.